home *** CD-ROM | disk | FTP | other *** search
/ The PC-SIG Library 10 / The PC-Sig Library - Shareware for the IBM PC and Compatibles (PC-SIG)(Tenth Edition Disks 1-2804)(1991).iso / PC_SIGCD / 15 / 3 / DISK1537.ZIP / README.DOC < prev    next >
Text File  |  1988-12-07  |  13KB  |  286 lines
  1.  
  2. PROCON UTILITIES Version 1.10  7/12/1988
  3.  
  4. Copyright (C) Peter E. King, 1988
  5.  
  6. ADDRESS:       ProCon Software
  7.                P.O. Box 43
  8.                Essendon
  9.                Victoria, 3040
  10.                AUSTRALIA.    
  11.  
  12.                (This is a Down Under product)
  13.  
  14.  
  15. Requirements:
  16.  
  17. IBM-PC or compatible with 1 or more disk drives.  DOS version 2.1 
  18. or  greater.   DUAL  screen  system  required  to  run  SWAP.COM, 
  19. SCREEN.COM  and DUALS.COM.   Your system must be BIOS  compatible 
  20. with the IBM-PC to run these programs.
  21.  
  22.  
  23. Copying and distribution:
  24.  
  25. PROCON  UTILITIES may  be copied and distributed as  a  SHAREWARE 
  26. program.   That  is  the  disk may be copied and  distributed  to 
  27. others   provided  that  ALL  files  on  this  disk  are   copied 
  28. unmodified (with the exception of HERCULES.COM and HERCULES.DOC).   
  29. It   may  only be distributed on BBS provided that all files  are 
  30. downloaded  using XMODEM.   The program may NOT  be used   as   a 
  31. value  added product and NO fee can be charged  except for a disk 
  32. and handling charge of up to $10 Australian or $6 U.S.
  33.  
  34. The copyright notices are to preserve my options,  and to protect 
  35. you  from  the  untoward modifications  of  others.   It  is  NOT 
  36. intended to prevent the public distribution of PROCON   UTILITIES 
  37. subject to the above limitations.
  38.  
  39. These  programs may NOT be utillized for business use  (including 
  40. government, semi-government and corporations) without the payment 
  41. of  the prescribed fee (excepting written permission from  Procon 
  42. Software).
  43.  
  44.  
  45. INTRODUCTION
  46. ============
  47.  
  48. Contained  on  this diskette are a collection of the most  useful 
  49. utilities  that  have  been written by  me.   Yes!   I  have  the 
  50. original assembler source code for ALL these programs.  They have 
  51. taken many months of work, in writing, testing and debugging.  If 
  52. you   find  them  useful  then  a  small  contribution  would  be 
  53. appreciated,  if you send $20 or more (Overseas subscribers  send 
  54. $20  U.S.)  you  will receive the latest  version  of  UTILITIES, 
  55. together  with  the  source  code for all  the  programs  (except 
  56. HERCULES).   As  a BONUS you will receive the EXECUTIVE  DECISION 
  57. MAKER  (EDM),  a fun pop-up program that allows you to make those 
  58. all important YES-NO decisions with ease.   Should I go out  with 
  59. susan?  Should I buy more Acme shares?  It's easy, It's fun!
  60.  
  61. P.S.       Although  other similar utility programs are available 
  62. in   the   public domain,   these programs generally  should   be 
  63. looked  upon  with  suspicion.   Many have been  written  by  in-
  64. experienced  people who do not fully understand the operation  of 
  65. the IBM-PC.   So,  if  your system is randomly CRASHING...   take 
  66. a  close  look at some of the memory-resident utilities  you  are 
  67. using!   AND DON'T LET ANY VIRUS INFECT YOUR SYSTEM!
  68.  
  69.  
  70. Suppport:
  71.  
  72. If   you are a contributor ,    I'll most happily  help you  with 
  73. any difficulties encounted.    Mail is  the preferred  method  of 
  74. exchange,   but  you  may also contact  me by telephone  on  (03) 
  75. 3364956.  That's in AUSTRALIA folks.
  76.  
  77. If  you are not a contributor (oh dear!),  please send a  stamped 
  78. SAE,  and I'll try to get back to you.  Remember, there's no such 
  79. thing as a free lunch!
  80.  
  81.  
  82. PROBLEMS AND ENHANCEMENTS
  83. =========================
  84.  
  85. I  am most certainly interested in any problems or bugs with  the 
  86. programs.   And,  indeed,  if  you have any suggestions  or  have 
  87. produced any enhancements to these programs I would be interested 
  88. in   hearing from you.    Please READ THE INSTRUCTIONS  CAREFULLY 
  89. before reporting any problems.
  90.  
  91. I  am  continually improving these programs.   Your  contribution 
  92. will  aid  the development of further programs and enhancements. 
  93.  
  94.  
  95. LIST OF FILES
  96. =============
  97.  
  98. HERCULES.COM        Memory resident CGA simulator
  99. HERCULES.DOC        Documentation for HERCULES.COM
  100.  
  101. BLANKS.COM          Memory resident automatically blanks screen
  102. BLANKS.DOC          Documentation for BLANKS.COM
  103.  
  104. CLOCKON.COM         Memory resident on-screen clock
  105. CLOCKON.DOC         Documentation for CLOCKON.COM
  106.  
  107. CLOCKSET.COM        Set real-time-clock from system clock
  108. CLOCKGET.COM        Set system clock from real-time-clock
  109. SETCLOCK.BAT        BATch file for CLOCKSET
  110.  
  111. CLOCK.SYS           Clock system call for auto. date rollover
  112. CONFIG.SYS          Configure system file for CLOCK.SYS
  113.  
  114. CLOCK.DOC           Documentation for CLOCK/SET/GET.COM/SYS
  115.  
  116. SWAP.COM            Swaps from one screen to the other
  117. SCREEN.COM          Use with IBM.PC to initialize screens
  118. DUALS.COM           Provides dual screen functioning
  119. DUALS.DOC           Documentation for SWAP/SCREEN/DUALS.COM
  120.  
  121.  
  122. NEW.DOC             New programs available from PROCON
  123. ORDER.DOC           Order form for PROCON UTILITIES
  124. README.DOC          This file
  125.  
  126.  
  127.  
  128. BLANKS.COM /BLANKS SCREEN
  129. =========================
  130.  
  131. This program automatically blanks the screen after 1 to 9 minutes 
  132. of  no keyboard or screen activity.   This will save your  screen 
  133. since  displays  will often become permanently  etched  into  the 
  134. screen  if they remain for long periods of time.   The time delay 
  135. may be set by using 'BLANKS /n' on the command line,  where n may 
  136. be 1 for one minute to 9 for nine minutes.   If '/n' is not given 
  137. the time defaults to three minutes.   Pressing any key, including 
  138. the Alt or Shift keys will restore the screen - without affecting 
  139. the  executing  program.   This  program is memory  resident  and 
  140. should only be invoked ONCE.   It can be included in the AUTOEXEC 
  141. file.
  142.  
  143. The  program works with both the MONO/HERCULES cards and the  CGA 
  144. card and blanks the entire screen - including the border!
  145.  
  146.  
  147. CLOCKON.COM /CLOCK ON-SCREEN
  148. ============================
  149.  
  150. This  program  provides  an on-screen clock display  in  the  top 
  151. right-hand corner.  It will work in all MONOCHROME and CGA screen 
  152. modes  (including GRAPHICS modes) and  may be toggled on and  off 
  153. by pressing the  Shift-ALT-Caps  Lock keys.    The blinking colon 
  154. also  provides   confirmation  that  interrupts are  on  and  the 
  155. computer has not  crashed!    This program is memory resident and 
  156. should  only  be  invoked  once.    It can  be  included  in  the 
  157. AUTOEXEC file.
  158.  
  159.  
  160. REAL TIME CLOCK ROUTINES
  161. ========================
  162.  
  163. The   files   CLOCKSET.COM,   CLOCKGET.COM and SETCLOCK.BAT  were  
  164. developed  to overcome  some of the limitations of the Real  Time 
  165. Clock  (RTC) programs  that utilize the MM58167 RTC chip.    This 
  166. chip  unfortunately  does not have a YEAR counter  and  does  not 
  167. correct  for leap years (i.e.   the 29th of Feb does not  exist).   
  168. The  above  programs  allow the RTC to be  set  from  the  system  
  169. clock,  it automatically rolls over the year counter (the program 
  170. TIMER  has a bug in  it)  and it automatically adjusts  for  leap 
  171. years.     A   feature    of   these  programs   is   that   they 
  172. automatically  search all the commonly used  addresses of the RTC 
  173. until one is found.   e.g.  These programs work with the  Persyst 
  174. Time Spectum card and most of the other RTC cards available.
  175.  
  176.  
  177. SETTING THE REAL-TIME CLOCK
  178. ---------------------------
  179.  
  180. Enter  SETCLOCK and press RETURN.   You will be asked to set  the 
  181. systems  date  and  then time.    The CLOCKSET.COM  program  will 
  182. automatically set your  Real Time Clock (RTC) - if you have one!
  183.  
  184.  
  185. SETTING THE SYSTEM TIME/DATE AUTOMATICALLY
  186. ------------------------------------------
  187.  
  188. You may already have an AUTOEXEC.BAT file on your System disk, if 
  189. not  create  one using the COPY command or Editor  (i.e.  EDLIN).  
  190. Insert the word CLOCKGET into the file,  this will  automatically 
  191. set  the  systems  time/date to the Real Time   Clocks  when  you 
  192. start-up the system.    If you already have an AUTOEXEC file then 
  193. delete  DATE  and TIME and insert CLOCKGET.   You will no  longer 
  194. need to set the time and date AND it will always be correct  when 
  195. you power up.
  196.  
  197.  
  198. SPECIAL NOTE
  199. ------------
  200.  
  201. The  RTC  may  need to be re-adjusted again for DAY-LIGHT  SAVING  
  202. time   and  occationally   when  it is corrupted  if  the  system 
  203. crashes.    Simply  run  the SETCLOCK Batch(BAT) program again to 
  204. reset  it.    If  your time and date  from the RTC  is  corrupted 
  205. often, try changing the cards address.
  206.  
  207.  
  208. SYSTEM FILES
  209. ------------
  210.  
  211. The    CLOCK.SYS   device  driver  is  provided  to   allow   the  
  212. DATE   to    be  incremented   when  the   TIME  clocks  over  to 
  213. 00:00:00.00.    This   is  done  already in DOS version 3 but not 
  214. in  version  2.     It is also useful  in  DOS version 3  because 
  215. some   programs  (i.e.    on-screen clocks  etc) may 'steal'  the 
  216. timer flag indicating that the clock has passed 24 hours.   Also,  
  217. since this driver monitors the system timer  continually,    date 
  218. increments  cannot  be  lost when the time is  not  read  for  24 
  219. hours.     To  install the  driver  simply   copy  CLOCK.SYS   to  
  220. your  boot  disk  and  include  DEVICE  =    CLOCK.SYS   in  your 
  221. CONFIG.SYS file.  If one does not exist then copy the one on this 
  222. disk to your boot disk.
  223.  
  224.  
  225. DUAL SCREEN PROGRAMS
  226. ====================
  227.  
  228. The programs SWAP.COM,  SCREEN.COM and DUALS.COM are intended for 
  229. use  with a dual screen system.   That is a system that has  BOTH 
  230. the  mono (or mono-graphics) card and the color graphics  adapter 
  231. (CGA)  card  installed.   You may wonder why one should do  this?  
  232. Well  ...  for someone like myself,  who's constantly  developing 
  233. programs  for the IBM-PC,  it allows me to test programs  written 
  234. for  the  different video interfaces simply by  swapping  screens 
  235. using the SWAP command.  Some programs have even been written for 
  236. dual screen use.  One, which is useful to me, is Microsoft's CODE 
  237. VIEW.   I  can now debug a graphics program,  with  it's  display 
  238. being  on  the  color monitor whilst CODE VIEW displays  all  the 
  239. program  lines  and  register contents  etc.  on  the  monochrome 
  240. screen.   Other programs, such as AUTOCAD, can do the same thing.  
  241. Graphics  can  be displayed on the color screen  whilst  text  is 
  242. entered on the mono screen.
  243.  
  244. One  of the problems encounted with the standard IBM-PC system is 
  245. that it does not initialize both screens when  powering-up.   The 
  246. SCREEN  program  can  be inserted in your  AUTOEXEC.BAT  file  to 
  247. provide  this  initialization and blanking of screens  (including 
  248. turning off the blinking cursor) automatically.
  249.  
  250. The SWAP command allows you to swap from one screen to the other.  
  251. This  command automatically determines what screen is being  used 
  252. and  swaps to the other.   The originating screen is cleared  and 
  253. its  cursor is blanked,  whilst the destination screen is cleared 
  254. and  its cursor turned on.   i.e.  You always know  which  screen 
  255. you're on by the blinking cursor!
  256.  
  257. The DUALS program was written to allow the two screens to be used 
  258. from  a  GWBASIC  or BASICA program as no  programming  langauage 
  259. (that I'm aware of) supports dual screen operation.   DUALS is  a 
  260. memory resident program that should only be executed ONCE.  After 
  261. it  has been executed,  invoke GWBASIC and you will find that you 
  262. can simply swap from one screen to the other by selecting  either 
  263. the text mode (0),  black & white (0) for the the mono screen and 
  264. text  mode  (0),  color enabled (1) for the color  screen.   e.g. 
  265. execute SCREEN 0,0 for mono and SCREEN 0,1 for color.  By-the-way 
  266. selecting  any graphics mode (1 or 2) switches  automatically  to 
  267. the  color graphics screen.   The destination screen is  blanked.  
  268. This  allows information to be written to one screen then you can 
  269. change to the other and write more information (allowing text  on 
  270. one  screen and graphics on the other for example).
  271.  
  272. One  important  feature of DUALS is that it has been designed  to 
  273. allow  you  to 'fool' GWBASIC into believing that it  is  in  the 
  274. graphics  mode  whilst  text i/o is being conducted on  the  mono 
  275. screen.   Simply invoke the graphics mode required (i.e.  1 or 2) 
  276. then execute SHELL "SWAP" (make sure command.com and swap.com are 
  277. available).   The  graphics screen will be blanked and  then  the 
  278. cursor  will  re-appear  on the monoscreen.   You can  now  enter 
  279. graphics commands directly and watch what they do on the graphics 
  280. screen  (without  annoying  text  appearing).   It's  great  from 
  281. demonstrating  and  experimenting with the graphics  commands  in 
  282. BASIC.
  283.  
  284. (C) COPYRIGHT 1988,PROCON SOFTWARE,BOX 43,ESSENDON 3040,AUSTRALIA
  285.  
  286.